home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / telecomm / fido / requestor.lha / requestor / Requestor.doc < prev    next >
Encoding:
Text File  |  1995-02-05  |  81.4 KB  |  2,467 lines
  1.  
  2.    This file documents REQUESTOR, a FileREQUESTOR that automatises your
  3.                            mail system.
  4.  
  5.    Copyright (C) 1993-1995 Stephan Kortleven
  6.  
  7.  
  8.    #####                                            ##
  9.    ##  ##                                           ##
  10.    ##  ##   ####    #####  ##  ##   ####    ####   #####    ####   #####
  11.    #####   ##  ##  ##  ##  ##  ##  ##  ##  ##       ##     ##  ##  ##  ##
  12.    ## ##   ######  ##  ##  ##  ##  ######   ####    ##     ##  ##  ##
  13.    ##  ##  ##       #####  ##  ##  ##          ##   ##     ##  ##  ##
  14.    ##  ##   ####       ##   #####   ####   #####     ###    ####   ##
  15.                        ##
  16.  
  17.                                REQUESTOR V2.0
  18.  
  19.               a FileREQUESTOR that automatises your mail system.
  20.  
  21.   'Preface            '
  22.   'Introduction       '
  23.   'Features           '
  24.   'What can it do ?   '
  25.   'Installation       '
  26.   'Menus              '
  27.   'Buttons            '
  28.   'Icon Tooltypes     '
  29.   'CLI Arguments      '
  30.   'Config File        '
  31.   'Requestor Junior   '
  32.   'Legal Stuff        '
  33.   'Program History    '
  34.   'Future plans       '
  35.   'Author Info        '
  36.   'Special thanks     '
  37.   'How did I do that ?'
  38.   'Possible failures  '
  39.  
  40.  
  41. Preface
  42. -------
  43.  
  44.    REQUESTOR is a Shareware program. The unregistered version will pop up
  45.    requesters at the end of the program, and you will have to click some
  46.    buttons with your mouse. Also, a few other functions are disabled in the
  47.    unregistered version:
  48.  
  49.  On the main Window :
  50.  
  51.  - The 'ForceDecr' checkbox is disabled in the unregistered version.
  52.  - The 'AppTimer' button is disabled in the unregistered version.
  53.  
  54.  At the Settings/Automatic Options window :
  55.  
  56.  - 'Poll' checkbox is disabled in the unregistered version.
  57.    So, the possibility to poll automatically when starting up REQUESTOR
  58.    will not work.
  59.  - 'AutoSession' checkbox is disabled in the unregistered version.
  60.    So, the possibility to poll automatically when starting up REQUESTOR
  61.    and quiting automatically when everything is done will not work.
  62.  - 'Decrunch Diffs' checkbox is disabled in the unregistered version.
  63.    So, automatic diff handling will not be possible.
  64.  - 'Decrunch Fileattach' checkbox is disabled in the unregistered version.
  65.    So, incoming archives can not be automatically decrunched.
  66.  - 'Quit' checkbox is disabled in the unregistered version.
  67.    After polling it will not be possible to quit automatically.
  68.  
  69. But still I have left you all a way to set all these unregistered options on.
  70. It's your job to find this way, OTHERWISE register yourself and you will
  71. receive a keyfile that enables all disabled options, so you can work like
  72. it's supposed to be.
  73.  
  74.  
  75. Introduction
  76. ------------
  77.  
  78.    This manual is a description of REQUESTOR. A FileRequester that
  79. automatises your mail system.
  80.  
  81.    To use REQUESTOR you will need a good mailer.  TrapDoor is suggested.
  82. You will need a good tosser too, Spot is suggested. Spot has been developped
  83. for use with TrapDoor and supports/uses many of TrapDoor's unique features.
  84. REQUESTOR V2.0 is specialy developped for use with TrapDoor and Spot so
  85. you will get a unique family. ;-) REQUESTOR V2.0 supports now only
  86. these two best programs of their kind. It's developped to make a link
  87. (communication channel) with these two programs by arexx from program feed,
  88. no scripts.
  89.  
  90.    REQUESTOR requires Workbench 2.0 or higher to run.  It uses many 2.04
  91. features and has been designed to be as user-friendly as possible.
  92.  
  93.  
  94. Features
  95. --------
  96.  
  97. * Requires Kickstart 2.04 or higher.
  98. * Locale support.
  99. * Keyboard short-cuts for most menus and Gadtools gadgets.
  100. * Commanding Spot through arexx.
  101. * Commanding TrapDoor through arexx.
  102. * Multiple phonenumbers calling uptill 10 numbers.
  103. * Mail backup.
  104. * Automatic delete mailbackup uptill 31 days.
  105. * Frequent filerequest uptill 100 days.
  106. * Early requested files check.
  107. * Automatic .Lha .Lzh .Run archive decrunching by Lha
  108. * Automatic .Zip archive decrunching
  109. * Automatic decrunching fileattach.
  110. * Automatic diff handling.
  111. * Automatic deleting unwanted files in archives.
  112. * Automatic deleting unwanted incoming files.
  113. * Automatic moving incoming files (by there extension) to there directory.
  114.   (.JPEG, .TIFF, ...)
  115. * Timer, to poll automatically at xx Hour, xx Minutes.
  116. * Aftersession part to run some extra batchs or programs on.
  117. * AppIcon to drop archives on to decrunch them automatically.
  118. * Multiple Config support (ASCII Format).
  119. * Support all screenformats, also public screens.
  120. * Complete TrapDoor session report.
  121.  
  122.   Some of these features are only available in the registered version.
  123.  
  124.   The program works with a personalised keyfile. So, if you like my work
  125.   please send a donation of 300 Belgian Franks or 10 US Dollar. 
  126.   Therefore you will receive a keyfile and will be briefed when a new 
  127.   VERSION becomes available.
  128.  
  129.  
  130. What can it do ?
  131. ----------------
  132.  
  133. 1°  Program :
  134.  
  135.     Run from Wb and CLI. Complete 2.0+ OS programming and look, menu and 
  136.     gadtools gadget support. The configuration can be set through the use of
  137.     an ASCII configfile. You can select Custom or Public screens to displays.
  138.     Locale support. Just put the catalog file in the REQUESTOR directory
  139.     REQUESTOR/locale/catalog/languages/REQUESTOR.Catalog or in the
  140.     locale:catalog/languages/REQUESTOR.Catalog and set your wb in the
  141.     selected languages with the prefs/locale program.
  142.  
  143. 2°  Frequent File-requests :
  144.  
  145.     Multiple file-requests that each can be set frequently.
  146.     Example: every 7 days request Amigafiles.lha... (uptill 100 days)
  147.  
  148. 3°  Multicall :
  149.  
  150.     Multicall with separated time settings to wait for next call (TrapDoor
  151.     Arexx connection with REQUESTOR). There are some arexx scripts to call
  152.     multiple phonenumbers. This program is 100% assembler code and will be
  153.     faster than arexx scripts. So, you can remove all those old scripts.
  154.  
  155. 4°  Mail Backup :
  156.  
  157.     Making a backup of your mail so you can restore it easily and import 
  158.     your mail again. 
  159.  
  160. 5°  Mailbackup Delete :
  161.  
  162.     With this option you can decide when the mail backup is old enough to
  163.     delete (Uptill 31 days).
  164.  
  165. 6°  Making a backup of the filerequest that you just did. A simple menu 
  166.     click will restore your last request.
  167.  
  168. 7°  Request check :
  169.  
  170.     Check which files you already requested and retain the possibility to
  171.     remove or continue the item in this request. You will be prompted the 
  172.     time and date when you already requested this before.
  173.  
  174. 8°  Automatic mailimport :
  175.  
  176.     Decrunch automatically the mail in Spot (Spot arexx connection REQUESTOR)
  177.  
  178. 9°  Automatic moving of files :
  179.  
  180.     Sometimes you will receive files like .jpeg etc. These files should not
  181.     be handled by REQUESTOR. So, if you like, you could tell REQUESTOR to
  182.     move every file to a specified directory if the file is ending with
  183.     .JPEG etc...
  184.  
  185. 10° Automatic decrunching :
  186.  
  187.     Decrunch automatically all received .lha, .lzh, .run, .zip files that
  188.     have been requested. The destination directory for all decrunching can
  189.     be set. Frequently requested files can be decrunched in an other
  190.     selectable directory than those of the filerequest.
  191.  
  192.     If the archive has :
  193.     - no directory
  194.     - a directory with some external files except the .icon-file itself
  195.     - multiple directories.
  196.  
  197.     then REQUESTOR will put them together in one directory named after the
  198.     lha-file without the .lha extension. This way you can be sure the 
  199.     directory structure will not be a mess and everything is well separated.
  200.     If there is no iconfile for the directory it will be created. So, you 
  201.     can access your filerequest from WB and test your newly received 
  202.     software. Even if the chosen directory already exists, REQUESTOR
  203.     will create a new directory in the format of the file or directory and
  204.     will before this renaming the old directory to name(.backup1...99) and
  205.     then extract the archive.
  206.  
  207.     Once an archive has been handled the archive bit will be set and not
  208.     being handled anymore. Until, in the mainwindow the forcedecr checkbox
  209.     is set to the ON state.
  210.  
  211. 11° Fit on disk check :
  212.  
  213.     HD check. When extracting to disk, REQUESTOR will check first if it will
  214.     fit on your disk. If it doesn't fit, REQUESTOR will tell you this and
  215.     the archive will be skipped. It stays in the inbound, so you can have it
  216.     decrunched after making room on your device.
  217.  
  218. 12° AppTimer :
  219.  
  220.     If you click this button REQUESTOR will close itself and will be a
  221.     appicon on the workbench. Dropping a icon of a archive on this appicon
  222.     will wake up REQUESTOR and gives directly the command to decrunch
  223.     these archives. On every session you can tell REQUESTOR to add a
  224.     icon to the archive so it will be easyer to use for dropping. When the
  225.     appicon is active you could use the use timer option to let REQUESTOR
  226.     poll at a given hour and minutes.
  227.  
  228. 13° Afterssesion :
  229.  
  230.     This part leaves you the possibility to run some scripts or other
  231.     programs after REQUESTOR has done its work.
  232.  
  233. 14° Automatic diffhandling :
  234.  
  235.     Nodelist and Amylist users could tell REQUESTOR to handle there diff
  236.     files automatically. Example : NodeDiff.l?? or AmyDiff.z??. The "?"
  237.     stands for the always changing format of these files. Normaly you get
  238.     these files automatically by your bbs in a format like this NodeDiff.l03.
  239.     The "03" is changing every week and stands for the day of the year.
  240.     REQUESTOR will let free any possible chars at the "?". It will
  241.     automatically decrunch to the given directory of the nodelist and handled
  242.     by TrapList to add to the complete list.
  243.  
  244. 15° Complete TrapDoor report :
  245.  
  246.     Through arrex you will get a complete TrapDoor session report of what has
  247.     happened with the session. Some of these results are not correct
  248.     when you work with a not registered version of TrapDoor. Example all
  249.     send, received files by TrapDoor will allways be 0 in the unregistered
  250.     TrapDoor version. Therefore I implanted the ForceImport Checkbox to
  251.     force REQUESTOR to do a Spot mail Import after every poll. Use this if
  252.     you are a not a registerd TrapDoor user.
  253.  
  254. 16° Automatic deleting received files :
  255.  
  256.     If your bbs sends every time a file you don't need or you don't want.
  257.     You can set REQUESTOR to delete the file everytime it comes in.
  258.  
  259. 17° Automatic deleting in received archives :
  260.  
  261.     If bbs-info, placed in the archive by your local bbs, is killing your
  262.     nerves, you can let REQUESTOR delete these files in the archive
  263.     before extracting the archive.
  264.  
  265.  
  266. Installation
  267. ------------
  268.  
  269.    You can install REQUESTOR very easily. Just move or copy the whole
  270.    directory to the place you want to have it. Installation is completed !
  271.  
  272.    REQUESTOR does not need any assigns. I have decided to set the default
  273.    prefs regarding the mail: paths.  Mail:inbound, Mail:outbound like 
  274.    TrapDoor and Spot.
  275.    `MAIL:' is required by most other FidoNet software, so if you have 
  276.    already installed TrapDoor or Spot this will allready be assigned properly
  277.    and you will get no error messages when starting up REQUESTOR for the
  278.    first time.
  279.  
  280.    There is just one thing to remember: REQUESTOR 's data-files, etc.
  281.    have to be kept together in one directory called data. When REQUESTOR
  282.    starts up for the first time, it will notice there is no data directory
  283.    set. Therefore  REQUESTOR creates its own directory (data) at the
  284.    place the binaire code (the program itself) stands.
  285.    This path can be changed later on at the settings/paths menu (Remember
  286.    the data directory itself will be created automatically). To start iconify
  287.    with or without the timer activated, just copy/move REQUESTOR and
  288.    its icon to wb-startup. Create a config file for it, with the iconify
  289.    option (and the timer option) on. You can point the name of the config
  290.    file to use in the REQUESTOR icon 'tooltypes'. CONFIG=PATH.
  291.    If the specified config can't be found, automatically
  292.    "DataPath/data/REQUESTORDef.config" will be taken.
  293.    Another way to do this is simply to add the REQUESTOR program to
  294.    your s:user-startup. Example : Dh0:bbs/REQUESTOR/REQUESTOR configname
  295.  
  296.    Spot settings:
  297.  
  298. When you want to start from Spot you have to set these settings.
  299.  
  300. 1° - Choose Spot menu 'Settings\System'
  301. 2° - If you have more than one pointnumber, select first in the ADDRESS
  302.      listview which ADDRESS you want to set.
  303. 3° - Click in the stringbox after the word 'Poll'
  304. 4° - Type in path+REQUESTOR example: 'dh0:bbs/REQUESTOR/REQUESTOR'
  305. 5° - Set the Asynchronous switch on ! This is very important. If you don't
  306.      set the Asynchronous switch on REQUESTOR will not be able to get arexx
  307.      connection with Spot and will hang there doing nothing !
  308.  
  309. Installation done.
  310.  
  311.   REQUESTOR menu\settings:
  312.  
  313. The two most inportant parts of REQUESTOR settings are :
  314.  
  315. - Settings/Paths see 'Path'
  316.  
  317. - Setting/BBS    see 'BBS'
  318.  
  319. These two parts have to be set or REQUESTOR can't do its job well.
  320.  
  321. See also 'make config' it could reduce settingswork.
  322.  
  323. If you are at more than 1 bbs see also 'multiple pointsystem' !
  324.  
  325.  
  326. Multiple Pointsystem
  327. --------------------
  328.  
  329. IF you have a multiple pointsystem you can add the next argument to tell
  330. REQUESTOR the difference between the bbs's, so use the next argument:
  331.  
  332. at cliprompt or at Spot menu 'Settings\System' stringgadget poll
  333.  
  334. REQUESTOR nightbreed.config
  335.  
  336. or
  337.  
  338. REQUESTOR alpha.config
  339.  
  340.  
  341. Menus
  342. -----
  343.  
  344.   Project
  345.  
  346.   'Poll               '
  347.   'Decrunch           '
  348.   'About              '
  349.   'Guide              '
  350.   'User               '
  351.   'Quit               '
  352.  
  353.   Settings
  354.  
  355.   'General            '
  356.   'Paths              '
  357.   'BBS                '
  358.   'Frequently         '
  359.   'Auto Delete Files  '
  360.   'Automatic Options  '
  361.   'Timer              '
  362.   'Config             '
  363.  
  364.   Backup
  365.  
  366.   'Restore Backupmail '
  367.   'Restore Filerequest'
  368.  
  369.  
  370. Poll
  371. ----
  372.  
  373. Keyboard short-cut: Right-Amiga P or P for Poll button.
  374.  
  375. What does it do ?
  376.  
  377. First I have to say that all these functions only work if you have set them
  378. on at the 'settings/options' menu. They will work in the order
  379. they are numbered below.
  380.  
  381. 1°  OPTION 'Check Requested'
  382.     First it will check your request for dupes.
  383. 2°  OPTION 'Delete Backupmail'
  384.     This will delete all backupmail that is too old.
  385. 3°  This will be automatically done because you have asked to poll.
  386.     So, no option has to be on. In case you want to have a complete session
  387.     directly when starting up REQUESTOR then the 'Poll' or 'Autosession'
  388.     option has to be on. See below for further explanation about these two.
  389. 4°  OPTION 'Frequently Request'
  390.     Now REQUESTOR will check if there is any of the frequently requested
  391.     files coming in. So they can be unpacked.
  392. 5°  OPTION 'Backup Mail'
  393.     At his point REQUESTOR will make a backup of all received mail.
  394. 6°  OPTION 'Import'
  395.     It will command Spot to do an import.
  396.     Not registered TrapDoor users will have to read the 'ForceImport'
  397.     option.
  398. 7°  OPTION 'Delete In Archive'
  399.     At this point REQUESTOR will try to delete all specified files in the
  400.     received archives.
  401. 8°  OPTION 'Decrunch Filerequest'
  402.     At this point every requested file will be decrunched.
  403. 9°  OPTION 'Decrunch Diffs'
  404.     This will decrunch all received Diff files that are set.
  405. 10° OPTION 'extension Move'
  406.     This will move all files ending on the specified extensions.
  407. 11° OPTION 'Decrunch Fileattach'
  408.     At this point every other received file will be act like it was a
  409.     fileattach and decrunched.
  410. 12° OPTION 'Aftersession'
  411.     This will try to run all given commands set.
  412. 13° OPTION 'Delete Source Archive'
  413.     The received archive will be deleted when it's decrunched.
  414. 14° OPTION 'Add Icon On Archive'
  415.     At this point every received file will get a iconfile added.
  416. 15° OPTION 'Quit' or 'AutoSession'
  417.     At this point REQUESTOR will try to quit.
  418.     Further exmplanation below.
  419.  
  420. Automating your configuration with Poll, Quit & Autosession.
  421.  
  422. If your are a registered user you will be able to set the poll or autosession
  423. checkbox at the 'settings/options' menu.
  424.  
  425. When the poll checkbox is on REQUESTOR will poll your BBS when starting up.
  426. The quit checkbox will quit REQUESTOR after a poll session. These two
  427. checkboxs will work when running from WB or CLI but not at the same time.
  428. You can not set the Quit checkbox the same time the poll checkbox is active.
  429. Otherwise you will be never able to change your settings again. So the quit
  430. button will set off automatically when the poll checkbox is selected and
  431. otherwise.
  432.  
  433. For those people that still want a complete session :
  434.  
  435. Set the autosession checkbox to do these two things at the same time.
  436. (start,poll,do job,quit) But remember this will only work if you are running
  437. from cli or Spot.
  438.  
  439. You could still be playing false by setting the config file quit and poll
  440. options ON, now it will be possible to run a complete session from WB. But
  441. remember you only can change these settings by setting one of these options
  442. off again in the ASCII config file.
  443.  
  444. When none of these options are active you have to decide when you want to
  445. poll your boss. Polling your BBS can be done by selecting this menu item,
  446. the Poll shortcutkey Right Amiga P, the "P" key or the poll gadget.
  447.  
  448.  
  449. Decrunch
  450. --------
  451.  
  452. Keyboard short-cut: Right-Amiga D (D for Decrunch button)
  453.  
  454. What does it do ?
  455.  
  456. Look at the explanation at 'poll'. The same steps will be made
  457. as in the poll menu except we will start now at point 6.
  458.  
  459.  
  460. About
  461. -----
  462.  
  463. Keyboard short-cut: Right-Amiga A
  464.  
  465. Some Copyright notes about REQUESTOR.
  466.  
  467.  
  468. GuideFile
  469. ---------
  470.  
  471. Keyboard short-cut: Right-Amiga G
  472.  
  473. Selecting this menu will try to start amigaguide with this guidefile so
  474. there is always the posibility to get direct explanation of the program.
  475.  
  476.  
  477. User
  478. ----
  479.  
  480. Keyboard short-cut: Right-Amiga U
  481.  
  482. This menu item will only give you a registration message, if you are not a
  483. registered user. Otherwise it will give information about the registered
  484. person.
  485.  
  486.  
  487. Quit
  488. ----
  489.  
  490. Keyboard short-cut: Right-Amiga Q
  491.  
  492. I think you get the picture. ;-) This will quit the program and will first
  493. ask if it's necessary to save the changes that were made.
  494.  
  495.  
  496. General
  497. -------
  498.  
  499.                CLI Output
  500.  
  501.       '      Output String      '
  502.  
  503.                  Screen
  504.  
  505.       '   Public screen String   '
  506.       '       Cycle gadget       '
  507.       'Screen'  'Font'  'Palette'
  508.  
  509.                  Colors
  510.  
  511.       +---------------------------+
  512.       |                           |
  513.       |                           |
  514.       |                           |
  515.       +---------------------------+
  516.       '       Cycle gadget       '
  517.       '   Test   '   '   Reset   '
  518.  
  519.  
  520. Output Device
  521. -------------
  522.  
  523. At this stringgadget you can set which output device REQUESTOR has to use.
  524. On this device will all the unpacking etc be promped. Some examples of legal
  525. device. 
  526.  
  527. the format is
  528.  
  529. device:xpos/ypos/width/height/name/type
  530.  
  531. For no output use
  532.  
  533. NIL:
  534.  
  535. For standard output use
  536.  
  537. Con:0/0/640/256/REQUESTOR
  538. Con:0/150/640/50/REQUESTOR/AUto
  539. Con:0/200/640/50/REQUESTOR/CLOSE
  540. Con:0/100/640/100/REQUESTOR/BACKDROP
  541. Con:0/150/300/50/REQUESTOR/NOBORDER
  542. Con:0/100/300/100/REQUESTOR/NODRAG
  543. Con:0/150/640/50/REQUESTOR/NOSIZE
  544. Con:0/150/640/50/REQUESTOR/SCREEN SPOT
  545. Con:0/150/640/50/REQUESTOR/SIMPLE
  546. Con:0/150/640/50/REQUESTOR/SMART
  547.  
  548. Or for kcon: users
  549.  
  550. KCON:0/0/640/256/REQUESTOR
  551. KCON:0/150/640/50/REQUESTOR/AUto
  552. KCON:0/200/640/50/REQUESTOR/CLOSE
  553. KCON:0/100/640/100/REQUESTOR/BACKDROP
  554. KCON:0/150/300/50/REQUESTOR/NOBORDER
  555. KCON:0/100/300/100/REQUESTOR/NODRAG
  556. KCON:0/150/640/50/REQUESTOR/NOSIZE
  557. KCON:0/150/640/50/REQUESTOR/SCREEN SPOT
  558. KCON:0/150/640/50/REQUESTOR/SIMPLE
  559. KCON:0/150/640/50/REQUESTOR/SMART
  560.  
  561. For explanation of these window types, look at your amigados references
  562. manual.
  563.  
  564.  
  565. Public screen name
  566. ------------------
  567.  
  568. This string is used to set the public screen name in if you want to use a
  569. public screen. When typing in the cycle gadget beneath this will
  570. automatically cycle to public screen. Changing between public and custom
  571. screen is always possible with the beneath cyclegadget without changing the
  572. stringgadget. If the public screen is not found REQUESTOR takes
  573. automatically the workbench screen as public screen.
  574.  
  575.  
  576. Screen cycle gadget
  577. -------------------
  578.  
  579. With this cycle gadget you can always swap from public to custom screen and
  580. otherwise.
  581.  
  582. Posible positions :
  583.  
  584. - Public Screen
  585. - Custom Screen
  586.  
  587. PS) if the public screen can not be found REQUESTOR uses automatically the
  588. workbench as public screen.
  589.  
  590.  
  591. Screen mode requester
  592. ---------------------
  593.  
  594. Clicking on this button will popup a reqtools screenmode requester with the
  595. posibility to change screen format, overscan, colors, etc...
  596. It would be stupid to choose a screen format with more colors than 16.
  597. REQUESTOR hase only the possibility to place 9 different colorpens, but
  598. still this can change in future. The default colors of a custom screen are
  599. 8.
  600.  
  601.  
  602. Font requester
  603. --------------
  604.  
  605. Clicking on this button will popup a reqtools font requester with the
  606. possibility to change the font.
  607.  
  608.  
  609. Palette requester
  610. -----------------
  611.  
  612. Clicking on this button will popup a reqtools font palette requester with
  613. the posibility to change from palette. REQUESTOR saves all Palette settings
  614. in AGA format even if you are working on a non AGA machine. This is done to
  615. make compatibility with other config files etc...
  616.  
  617.  
  618. Cycle gadget color settings
  619. ---------------------------
  620.  
  621. Next screenpens could be set like you want. Clicking on above color will
  622. change the pencolor.
  623.  
  624. Posible positions :
  625.  
  626. - Gadget Text
  627. - Shine
  628. - Shadow
  629. - Window Title Backg.
  630. - Window Title Text
  631. - Gadget Background
  632. - Highlight
  633. - Menu box
  634. - Menus Background
  635. - Menu Text
  636. - Gadget Text
  637.  
  638.  
  639. Color test
  640. ----------
  641.  
  642. This button is added so you don't have to close your windows or
  643. REQUESTOR itself to see the changing. Pushing this button will close
  644. all windows and screens and reopen them so you can see the result of the
  645. colorchange.
  646.  
  647.  
  648. Colors Reset
  649. ------------
  650.  
  651. When colors are selected in the wrong way it could be possible you can't read
  652. any text anymore. Clicking on this gadget will reset the colors to default
  653. colors.
  654.  
  655.  
  656. Path settings
  657. -------------
  658.  
  659.     Lha      'Stringgadget' '@'
  660.     Unzip    'Stringgadget' '@'
  661.     Zip      'Stringgadget' '@'
  662.     Spot     'Stringgadget' '@'
  663.     TrapDoor 'Stringgadget' '@'
  664.     TrapList 'Stringgadget' '@'
  665.     Data     'Stringgadget' '@'
  666.  
  667.  
  668. Stringgadget paths
  669. ------------------
  670.  
  671. In this stringgadget you can put the complete path of the item marked before.
  672. If the path does not exist, it will change back to the old settings.
  673. There will be automatically a / or : added.
  674.  
  675. PS) If the paths are not set correctly REQUESTOR can't do its job like it
  676. should. Requester will put a message to check the path.
  677.  
  678. With Lha, Unzip, Zip, Spot, TrapDoor and TrapList we mean the executables
  679. of those programs. To avoid playing with other programs the names will be
  680. added internal so you will have only to select the directory.
  681.  
  682. The Data directory is the directory where all mailbackup, configs etc will
  683. be kept together. The directory data will be created in the selected
  684. directory. So do not select a existing REQUESTOR data directory or you will
  685. create an other data directory in it !
  686.  
  687.  
  688. Path requester
  689. --------------
  690.  
  691. This will popup a reqtools path requester. Select the complete path of the
  692. item marked before and click on the ok button.
  693. If the path does not exists it will change back to the old settings.
  694. There will be automaticly a / or : added.
  695.  
  696. PS) If the paths are not set correctly REQUESTOR can't do its job like it
  697. would have to be. Requester will put then a message to check the path.
  698.  
  699. With Lha, Unzip, Zip, Spot, TrapDoor and TrapList we mean the executables
  700. of those programs. To avoid playing with other programs the names will be
  701. added internally so you will have only to select the directory.
  702.  
  703. The Data directory is the directory where all mailbackup, configs etc will
  704. be kept together. The directory data will be created in the selected
  705. directory. So do not select a existing REQUESTOR data directory or you will
  706. create another data directory in it !
  707.  
  708.  
  709. BBS Settings
  710. ------------
  711.  
  712.      BBS Name '   Stringgadget      '
  713.     Your Node '   Stringgadget      '
  714.  Request File '   Stringgadget   ' '@'
  715.    Import Dir '   Stringgadget   ' '@'
  716.   Destination '   Stringgadget   ' '@'
  717.    Fileattach '   Stringgadget   ' '@'
  718.               +---------------------++
  719.               | 10 016640099        ||
  720.  Phonenumbers | 10 016640872        ||
  721.               | 10 016640912        ||
  722.               +---------------------++
  723.   Phonenumber '   Stringgadget      '
  724.     Delay x s '   Slider gadget     '
  725.  
  726.  
  727. Stringgadget BBS
  728. ----------------
  729.  
  730. In this stringgadget you have to put the name of the bbs this configfile is
  731. for. It's not nessecary but recommended for clearness.
  732.  
  733.  
  734. Stringadget NODE
  735. ----------------
  736.  
  737. In this stringgadget you have to put your nodename. The node name is the
  738. number you did receive from your local bbs to logon with. Without this
  739. number your bbs does not accept your call.
  740.  
  741.  
  742. Stringgadget Request File
  743. -------------------------
  744.  
  745. In this stringgadget you can put the complete filepath of the file where you
  746. will request with. Normaly this will in the format as your pointnumber or
  747. nodenumber. If your pointnumber will be 2:292/603.35 (it'is mine.;-) ) then
  748. you have to choose 2.292.603.0.REQ. A simple way to check you are right try
  749. to request a file with Spot and look in outbound: directory, this is the
  750. file you need. Don't forget to type in first which path, normally
  751. mail:outbound/ or outbound:. If the path/file is not correct it will change
  752. back to the old settings.
  753.  
  754.  
  755. Request File
  756. ------------
  757.  
  758. This will popup a reqtools file requester. Select the complete path of the
  759. file where you will request with. Normaly this will in the format as your
  760. pointnumber or nodenumber. If your pointnumber will be 2:292/603.35 (it's
  761. mine.;-) ) then you have to choose 2.292.603.0.REQ. A simple way to check
  762. you are right try to request a file with Spot and look in outbound:
  763. directory, this is the file you need. Don't forget to type in first which
  764. path, normally mail:outbound/ or outbound:. If the path/file is not correct
  765. it will change back to the old settings.
  766.  
  767.  
  768. Stringgadget Import Path
  769. ------------------------
  770.  
  771. In this stringgadget you can put the complete path where alle received files
  772. come in. This is normally inbound:
  773.  
  774.  
  775. Import Path
  776. -----------
  777.  
  778. This will popup a reqtools file requester. Select the complete path where
  779. all received file come in this is normally inbound:
  780.  
  781.  
  782. Stringgadget Destination Path
  783. -----------------------------
  784.  
  785. In this stringgadget you can put the complete path where all received files
  786. go to after extracting (unpacking).
  787.  
  788.  
  789. Destination Path
  790. ----------------
  791.  
  792. This will popup a reqtools file requester. Select the complete path where
  793. all received files go to after extracting (unpacking).
  794.  
  795.  
  796. Stringgadget Fileattach Path
  797. ----------------------------
  798.  
  799. In this stringgadget you can put the complete path where all received files
  800. go to after extracting (unpacking). With Fileattach we have to keep in mind
  801. that we mean files that are received but not requested. So, no frequently
  802. requested files or diffs etc..
  803.  
  804.  
  805. Fileattach Path
  806. ---------------
  807.  
  808. This will popup a reqtools file requester. Select the complete path where
  809. all received files go to after extracting (unpacking). With Fileattach we
  810. have to keep in mind that we mean files that are received but not requested.
  811. So, No Frequently requested files or diffs etc..
  812.  
  813.  
  814. StringGadget Phonenumbers
  815. -------------------------
  816.  
  817. At this point you can add phonenumbers by typing them in the stringgadget.
  818. They will be placed in the listview above. Clicking a phomenumber in the
  819. listview will place the phonenumber back to this stringgadget to change.
  820. Deleting all chars and pressing return afterwards will result in removing
  821. the phonenumer from the listview.
  822.  
  823.  
  824. Slider Gadget Time/Date
  825. -----------------------
  826.  
  827. By this slider gadget you can change the time/date by moving its position to
  828. the leftside = decrease or to the right side = increase. The result will be
  829. shown at the left side of the slider gadget.
  830.  
  831.  
  832. Frequently Settings
  833. -------------------
  834.  
  835.           Type '       Cycle gadget       '
  836.    Destination '     Stringgadget      ' '@'
  837.                +---------------------------+
  838.                |                           |
  839.                |                           |
  840.     Actionlist |                           |
  841.                |                           |
  842.                |                           |
  843.                +---------------------------+
  844.         Action '      String gadget    ' '@'
  845.         x days '      Slider gadget       '
  846.  
  847. PS) Look at the cycle gadget which option has to be set for working !
  848.  
  849.  
  850. Frequently type
  851. ---------------
  852.  
  853. Posible positions are :
  854.  
  855.   '  Frequently  ' option has to be on for working !
  856.   ' Aftersession ' option has to be on for working !
  857.   '     Diffs    ' option has to be on for working !
  858.   'Extension Move' option has to be on for working !
  859.  
  860.  
  861. Frequently
  862. ----------
  863.  
  864. At this point you can add at the action stringgadget which file you want to
  865. receive frequently. With the slider gadget you can always change the days
  866. before doing a new request. At the stringgadget path you can change the
  867. destination path of the frequently requested files. Only 1 destination is
  868. allowed for all frequently files recently. The file requester at the
  869. actionstring is disabled and only of use when working on the aftersession.
  870. In the list view you will always see first a number, this stands for the
  871. couple of days you have specified to wait. Secondly you will see a date this
  872. will mark the day of the new frequently request of that file. And last but
  873. not least the file itself that will be put in your request.
  874.  
  875. Remember to set this option ON 'Frequently Request' if you want to have this
  876. working !
  877.  
  878.  
  879. Aftersession
  880. ------------
  881.  
  882. At this point you can add executables or batches to start after
  883. we have done a session. The ouput will be promped at the given cli-window.
  884. You could use the filerequester at the stringgadget action to select files
  885. to execute. For batch files use always first the execute command. For
  886. assyncronously running programs you will have to use the run command.
  887. Note : When using the run command the REQUESTOR cli window will not be
  888. closed until the last run command has finished its job. So notice this if
  889. your cliwindow is still open while REQUESTOR has finished. If the background
  890. task is finished the REQUESTOR cli window will be closed automatically
  891. too.
  892.  
  893. Examples :
  894.  
  895. Spot
  896. execute s:checkfiles
  897. run TrapDoor answer
  898.  
  899. Note !
  900.  
  901. Destination stringgadget, pathrequest and the days slidergadget will be
  902. disabled because they are of no use.
  903.  
  904. Remember to set this option ON 'Aftersession' if you want to have this
  905. working !
  906.  
  907.  
  908. Diffs
  909. -----
  910.  
  911. At this point you you can add which diff files has to be recognized.
  912. This can be done using a "?". Diff files always have another name because
  913. they use the 2 last chars as the 2 last chars from the number of week they
  914. exist.
  915.  
  916. example : NodeDiff 301 will be NodeDiff.z01
  917.           you type in NodeDiff.z??
  918. Wrong !   Nodediff.???
  919.  
  920. REQUESTOR looks at the last .z?? chars to see if it's a zip archive or
  921. .l?? for .lha archive. In future version I plan to use the "WhatIs.library"
  922. or datatypes to see the differences between the archives. You may specify
  923. in which directory the decrunched archives has to come with the string or
  924. pathrequester at destination. Only one destination can be selected for all
  925. diffs. Normally this will be Nodelist:. Afterwards REQUESTOR will run
  926. TrapList to do the job.
  927.  
  928. Note ! The filerequester after the stringgadget and the slider gadget are
  929. disabled because they are not of use.
  930.  
  931. To receive these Diff files you have to contact your bbs. They will send
  932. them to you. The first time you wil receive a file from 3 meg with all
  933. network adresses in them. Afterwards you will receive every week an update
  934. called diff files from +/-50kb. With this nodelist (every week updated and
  935. processed by TrapList) you can use message/info from Spot to see where the
  936. message writer lives, and you can call his BBS's directly by his nodenumber
  937. instead of his phonenumber. See the TrapList manual for more details.
  938.  
  939. Remember to set this option ON 'Decrunch Diffs' if you want to have this
  940. working !
  941.  
  942.  
  943. Extension Move
  944. --------------
  945.  
  946. At this point you can set which extension REQUESTOR has to recognize. If
  947. you put in at the action stringgadget ".jpeg". All files ending on .jpeg
  948. will be moved at the directory specified at destination stringgadget or path
  949. REQUESTOR. You select always first the directory and afterwards the
  950. extension so you could have always a different destination directory.
  951. Remember that the extension can only be 10 characters long. Everything
  952. greater then 10 characters will be cut down untill 10 characters.
  953.  
  954. If the file allready exist on the destination then it will be renamed to
  955. name.Backup(1..99) so the file can be moved.
  956.  
  957. Note !
  958.  
  959. Note ! The file requester after the stringgadget and the slider gadget are
  960. disabled because they are not of use.
  961.  
  962. Remember to set this option ON 'extension Move' if you want to have this
  963. working !
  964.  
  965.  
  966. Stringgadget Frequently paths
  967. -----------------------------
  968.  
  969. In this stringgadget you can put the complete path of wanted directory.
  970. If the path does not exist, it will change back to the old settings.
  971. There will be automatically a / or : added.
  972.  
  973. PS) If the paths are not set correctly REQUESTOR will replace the old path
  974. back.
  975.  
  976. The paths are different for every cycle position.
  977.  
  978. - Frequently     : Only one directory can be set for all frequently
  979.                    requested files. All unpacked archives are stored there.
  980.                    Remember when using Frequently files they will not be
  981.                    checked if they are kept in one directory and they will
  982.                    overwrite allways the previous file.
  983. - Aftersession   : Disabled, so not of use
  984. - Diffs          : Only one directory can be set for all selected diffs,
  985.                    this will normaly be nodelist:
  986. - Extension Move : For every extension you choose a directory can be set.
  987.                    Every time you add an extension the path will be added
  988.                    after it in the listview. So remember to set first the
  989.                    destination directory and later on add the extension.
  990.  
  991.  
  992. Path requester
  993. --------------
  994.  
  995. This will popup a reqtools path requester. Select the complete wanted path
  996. and click on the ok button.
  997. If the path does not exists it will change back to the old settings.
  998. There will be automaticly a / or : added.
  999.  
  1000. PS) If the paths are not set correctly REQUESTOR will replace the old path
  1001. back.
  1002.  
  1003. The paths are different for every cycle position.
  1004.  
  1005. - Frequently     : Only one directory can be set for all frequently requested
  1006.                    files. All unpacked archives are stored there. Remember
  1007.                    when using Frequently files they will not be check the are
  1008.                    kept in one directory and they will be overwrite allways
  1009.                    the previous filed.
  1010. - Aftersession   : Disabled, so not of use
  1011. - Diffs          : Only one directory can be set for all sellected diffs,
  1012.                    this will be normaly nodelist:
  1013. - Extension Move : For every extension you choose a directory can be set.
  1014.                    Every time you add a extension the path will be added
  1015.                    after it in the listview. So remeber to set first the
  1016.                    destination directory and later on add the extension.
  1017.  
  1018.  
  1019. Frequently Action Stringgadget
  1020. ------------------------------
  1021.  
  1022. At this point you can give in which action there must be done. The action is
  1023. specified by the position of the cycle gadget 'type'.
  1024. Everything added will be prompt at the listview above. Selecting an item at
  1025. the listview will place the text back to the stringgadget for changing.
  1026. Deleting all chars will result in removing that item.
  1027.  
  1028.  
  1029. File requester
  1030. --------------
  1031.  
  1032. This filerequester will only work when the cycle gadget stands in the
  1033. aftersession mode. It will be used for selecting executeables or scripts.
  1034.  
  1035.  
  1036. Auto Delete Files
  1037. -----------------
  1038.  
  1039.             Auto Delete Imported File
  1040.              +---------------------+
  1041.              |                     |
  1042.  Delete File |                     |
  1043.              |                     |
  1044.              +---------------------+
  1045.  Auto Delete '     Stringgadget    '
  1046.  
  1047.              Auto delete in archive
  1048.              +---------------------+
  1049.              |                     |
  1050.       Delete |                     |
  1051.              |                     |
  1052.              +---------------------+
  1053.  AutoDelFile '     Stringgadget    '
  1054.  
  1055.             Delete Mail Older Then...
  1056.       x days '    Slider gadget    '
  1057.  
  1058.  
  1059. Delete Imported Files
  1060. ---------------------
  1061.  
  1062. Some BBS have always on a filerequest some external file they send too. This
  1063. file could handle some advertising information you don't always want to to
  1064. see. At this point you can give at the delete file stringgadget which file
  1065. has to be deleted directly when coming in. Everyhing will be prompted in the
  1066. above listview by pressing the return key. Clicking on a item in the
  1067. listview will place the string back to the string gadget for changing.
  1068. Removing all chars from the stringgadget will kill the item. All output from
  1069. lha can be followed in the cli output window.
  1070.  
  1071. This has no option to turned off so if they are no files given in there will
  1072. be no check taking place. If there were files they will be checked to be
  1073. the same as the received one. If they are the same they will be deleted !
  1074.  
  1075.  
  1076. Delete Files in Archives
  1077. ------------------------
  1078.  
  1079. Some BBS put always in a archive some extra file they want you to see. This
  1080. file could handle some bbs information you don't always want to to see.
  1081. Normally this information will scramble the hole directory structure
  1082. because you now have some internal files extra in the archive. REQUESTOR
  1083. will see them as extra files and places always everything in a new called
  1084. directory. When adding these files to this section they will first be removed
  1085. from the archive before extracting. This is very interesting if you want to
  1086. hold these archives by setting the option autodelete source archive off. All
  1087. handled archives have now directly these unwanted files removed. You can give
  1088. at the AutoDelFile stringgadget which file has to be deleted directly when
  1089. extracting. Everything will be prompted in the above listview by pressing
  1090. return. Clicking on an item in the listview will place the string back to the
  1091. string gadget for changing. Removing all chars from the stringgadget wil
  1092. kill the item. All output from lha can be followed in the cli output window.
  1093.  
  1094. Remember to set this option ON 'Delete In Archive' if you want to have
  1095. this working !
  1096.  
  1097.  
  1098. Delete Backup Mail older then x days
  1099. ------------------------------------
  1100.  
  1101. By this slider gadget you can change the number of days the backupmail may
  1102. be old. Its position to the leftside will decrease and moving to the right
  1103. side will increase the number of days. The result will be shown at the left
  1104. side of the slider gadget.
  1105.  
  1106. Remember to set this option ON 'Delete Backupmail' if you want to have
  1107. this working !
  1108.  
  1109.  
  1110. Automatic Options
  1111. -----------------
  1112.  
  1113. '' Check Requested        '' Decrunch Diffs
  1114. '' Frequently Request     '' Decrunch Fileattach
  1115. '' Delete Backupmail      '' Delete Source Archive
  1116. '' Poll                   '' extension Move
  1117. '' Auto Session           '' Aftersession
  1118. '' Backup Mail            '' Quit
  1119. '' Import                 '' Use timer
  1120. '' Force Import           '' Add Icon On Archive
  1121. '' Delete In Archive      '' Iconify
  1122. '' Decrunch Filerequest
  1123.  
  1124.  
  1125. Check Requested
  1126. ---------------
  1127.  
  1128.     OPTION Check Requested ON
  1129.  
  1130.     It will check your request for dupes. If so, you have the possibility to
  1131.     Remove the requested file by answring 'No' or continue the requested file
  1132.     by clicking 'Yes'.
  1133.  
  1134.     An other possibility is to choose the 'All' button which defines you are
  1135.     sure that all the rest of requested files that haves been earlier
  1136.     requested include this request. Clicking the 'Remove All' button will
  1137.     remove all the rest of the earlier requested files.
  1138.  
  1139.  
  1140. Frequently Request
  1141. ------------------
  1142.  
  1143.     OPTION Frequently Request ON
  1144.  
  1145.     REQUESTOR will check if there is any of the frequently requested files
  1146.     coming in. If so, it wil decrunch these archives when possible and
  1147.     places these decrunched versions in the specified directory. No renaming
  1148.     or directory will be made. It will overwrite the old files. This is done
  1149.     to update regular files like bbs file list etc...
  1150.  
  1151.     You can add Frequently Requested files at the 'Setting/Frequently'
  1152.     menu.
  1153.  
  1154.  
  1155. Delete Backupmail
  1156. -----------------
  1157.  
  1158.     OPTION Delete Backupmail ON
  1159.  
  1160.     This will delete all backupmail that is older then the number of days
  1161.     specified with the slider gadget in the menu
  1162.     'settings/auto delete files'
  1163.  
  1164.  
  1165. Poll
  1166. ----
  1167.  
  1168.     OPTION Poll ON
  1169.  
  1170.     When this option is set REQUESTOR handles everything automatically. When
  1171.     starting up REQUESTOR will start directly polling and doing every option
  1172.     that is set until it has done everything.
  1173.  
  1174.     It will try to start TrapDoor at the path given in the 'settings/paths'
  1175.     menu. If no path is given it will search in your C: directory for
  1176.     TrapDoor to start.
  1177.  
  1178.     If it has no succes you will be prompted to check the path at the main
  1179.     window, listview status. If it manages to start TrapDoor, it starts
  1180.     TrapDoor in answer mode with your nodename added which is very important
  1181.     when you are a multiple bbs user. TrapDoor will now wait for any arexx
  1182.     command at its arexx port. The selected phonenumbers given in the
  1183.     listview of the 'settings/bbs' menu will be sent to TrapDoor for
  1184.     calling.
  1185.  
  1186.     Before calling the next phonenumber (or the same phonenumber again if no
  1187.     other has been given). REQUESTOR will wait before sending the next (or
  1188.     the same) phonenumber to TrapDoor. It will wait for the given seconds
  1189.     marked before the phonenumber in the listview of the 'settings/bbs'
  1190.     menu.
  1191.  
  1192.     The retries will be repeated as long as no connection is made. After the
  1193.     connection is made, it will send a command to TrapDoor to quit.
  1194.     If you use the unmodified TrapDoor.cfg you can always quit TrapDoor when
  1195.     it is trying to call (status line: calling....) by pressing the ESC
  1196.     key. You will hear a beep letting you know that TrapDoor is stopped.
  1197.     Pressing the ESC key while TrapDoor is waiting (status line: waiting x
  1198.     sec. before calling...). Will just initialize your modem again.
  1199.     A full report will be given by TrapDoor to REQUESTOR of what
  1200.     has happen. The poll option will unselect the quit option automatically
  1201.     and otherwise.
  1202.  
  1203.     See also 'Auto Session'
  1204.  
  1205.  
  1206. Auto Session
  1207. ------------
  1208.  
  1209.     OPTION AutoSession ON
  1210.     AutoSession will do the same as the 'poll' option except if everything is
  1211.     done it will quit REQUESTOR. Works only from cli or Spot. Why ? Very
  1212.     simple, otherwise you haven't anymore the possibility to set any option
  1213.     at all. Now you only have to run from wb to make changes. True wb
  1214.     REQUESTOR settings are always changeable because the poll and quit gadget
  1215.     can't be set the same time. You could always lie to the system by setting
  1216.     in the configfile poll and quit options to on position using a ASCII
  1217.     editor like golded. Then you will have also a complete session running
  1218.     from wb. But ! Don't forget to set them again to off position if you
  1219.     want to set some settings again. ;-)
  1220.  
  1221.  
  1222. Backup Mail
  1223. -----------
  1224.  
  1225.     OPTION Backup Mail ON
  1226.     When this option is set REQUESTOR will make a backup of all received
  1227.     mail in the inbound directory. The backup is placed in the REQUESTOR
  1228.     data/ directory.
  1229.  
  1230.  
  1231. Import
  1232. ------
  1233.  
  1234.     OPTION Import ON
  1235.  
  1236.     It will try to start Spot, if it's not allready running. The path of Spot
  1237.     has to be set at 'settings/paths'.
  1238.     Then it will try Spot to command to do a import through arexx and Spot
  1239.     will import all received mail. It decides to command Spot to import if
  1240.     TrapDoor gives the result of more than one file received by TrapDoor.
  1241.     If you are a not registered TrapDoor user look at the 'Force Import'
  1242.  
  1243.  
  1244. Force Import
  1245. ------------
  1246.  
  1247.     OPTION ForceImport ON
  1248.  
  1249.     Not registered TrapDoor users will always get as TrapDoor result of the
  1250.     session 0 files received/0 file send.
  1251.     So REQUESTOR will think there is no mail received and will not command
  1252.     Spot to import. With this option on Spot will be forced to import
  1253.     everytime TrapDoor has made a session even if there is no mail received.
  1254.  
  1255.  
  1256. Delete In Archive
  1257. -----------------
  1258.  
  1259.     OPTION Delete In Archive ON
  1260.  
  1261.     At this point REQUESTOR will try to delete all specified files in the
  1262.     received archives. The archives will not be unpacked they stay in
  1263.     archive format. The specified files are set at the
  1264.     'settings/auto delete files' menu.
  1265.  
  1266.  
  1267. Decrunch Filerequest
  1268. --------------------
  1269.  
  1270.     OPTION Decrunch Filerequest ON
  1271.  
  1272.     At this point every requested file will be decrunched. What it will do
  1273.     when decrunching you could read at 'What can it do' part of
  1274.     this guide item 10°. Every decrunched file will be placed at the
  1275.     destination directory set on the 'Settings/BBS' menu, item "Destination"
  1276.  
  1277.  
  1278. Decrunch Diffs
  1279. --------------
  1280.  
  1281.     OPTION Decrunch Diffs ON
  1282.  
  1283.     This will decrunch all received Diff files that are set in the
  1284.     'Setting/Frequently' menu, Toggle Cycle gadget untill diffs viewbox. a
  1285.     "?" stands for A not known char or a always changing character in the
  1286.     filename. Example : AmyDiff.l??
  1287.  
  1288.  
  1289. Decrunch Fileattach
  1290. -------------------
  1291.  
  1292.     OPTION Decrunch Fileattach ON
  1293.  
  1294.     At this point every other received file will be act like it was a
  1295.     fileattach and decrunched. What REQUESTOR will do when decrunching you
  1296.     could read at 'What can it do' part of this guide item 10°. Every
  1297.     decrunched file will be placed at the destination directory set on the
  1298.     'Settings/BBS' menu, item "Fileattach".
  1299.  
  1300.  
  1301. Delete Source Archive
  1302. ---------------------
  1303.  
  1304.     OPTION Delete Source Archive ON
  1305.  
  1306.     The received archive will be deleted when it's decrunched. So, you will
  1307.     keep the maximum room on your HD.
  1308.  
  1309.  
  1310. Extension Move
  1311. --------------
  1312.  
  1313.     OPTION Extension Move ON
  1314.  
  1315.     This will move all files ending on the specified extensions in the
  1316.     listview at the given directory set by 'Setting/Frequently' menu,
  1317.     Type extensionmove
  1318.  
  1319.  
  1320. Aftersession
  1321. ------------
  1322.  
  1323.     OPTION Aftersession ON
  1324.  
  1325.     This will try to run all given commands set at the listview in
  1326.     'Setting/Frequently' menu, toggle cycle gadget until aftersession. You
  1327.     can run a batch by using execute, a program by just typing the name in
  1328.     or a arexx prog by using the rx command. The programs are runned non
  1329.     asynchronous. So, if you want to run asynchronous you have to use the
  1330.     amigados run command.
  1331.  
  1332.  
  1333.  
  1334. Quit
  1335. ----
  1336.  
  1337.     OPTION Quit ON
  1338.  
  1339.     The quit option will automatically quit REQUESTOR after a session is
  1340.     done. The quit option will unselect the poll option automatically and
  1341.     otherwise. Why this is done you can read at the 'Auto Session' option.
  1342.  
  1343.  
  1344. Use Timer
  1345. ---------
  1346.  
  1347.     OPTION Use Timer ON
  1348.  
  1349.     When this option is set, the time set at 'Settings Timer' will be used
  1350.     when the icon is iconified. It will automatically do a complete poll
  1351.     session when the time is reached.
  1352.  
  1353.  
  1354. Add Icon On Archive
  1355. -------------------
  1356.  
  1357.     OPTION Add Icon On Archive ON
  1358.  
  1359.     At this point every received file will get a iconfile added. This is done
  1360.     to drop later on on the REQUESTOR appicon or for WB usage.
  1361.  
  1362.  
  1363. Iconify
  1364. -------
  1365.  
  1366.     OPTION Iconify ON
  1367.  
  1368.     Selecting this option will startup REQUESTOR iconified. If the use timer
  1369.     option is selected REQUESTOR will popup from iconified and start his
  1370.     session when the time is reached that was been set at settings/timer.
  1371.     You can always double click the appicon to popup REQUESTOR again or drop
  1372.     a .lha or .zip archive on it for decrunching.
  1373.  
  1374.  
  1375. Settings Timer
  1376. --------------
  1377.  
  1378.     x Hours '    Slider gadget    '
  1379.     x Mins  '    Slider gadget    '
  1380.  
  1381.  
  1382. Menu Settings Config
  1383. --------------------
  1384.  
  1385.   'Load               '
  1386.   'Save               '
  1387.   'Save As            '
  1388.   'Make As            '
  1389.  
  1390.  
  1391. Load Config
  1392. -----------
  1393.  
  1394. Keyboard short-cut: Right-Amiga L
  1395.  
  1396.    When selecting this menu a reqtools file requester will be opened to load
  1397. the config you want. Every setting will be changed to that of the new config.
  1398. An other possibility to load the configs when starting up is from cli as
  1399. argument or as icon tooltype with the keyword CONFIG="name"
  1400.  
  1401. REQUESTOR will always try to open REQUESTORDef.Config when starting up, if
  1402. no configfile is given as argument or as icon tooltype.
  1403.  
  1404. PS) It would be smart not to change the path so that REQUESTOR can find its
  1405. config directly. When using the argument or the icon tooltype the default
  1406. REQUESTORs data/ directory will be used. So, including an other path will
  1407. only result in errors.
  1408.  
  1409.  
  1410. Save Config
  1411. -----------
  1412.  
  1413. Keyboard short-cut: Right-Amiga S
  1414.  
  1415.    Every setting that has been changed will be saved in the config file.
  1416. The configfile is in ASCII format and can be found in the data/ directory.
  1417. The default path of this data directory will be saved in the env: envarc:
  1418. directory under the name REQUESTORPath. The configname will be always the
  1419. name of the last loaded config file.
  1420.  
  1421.  
  1422. Save Config As
  1423. --------------
  1424.  
  1425. Config:
  1426.  
  1427. Keyboard short-cut: Right-Amiga C
  1428.  
  1429.    When selecting this menu a reqtools file requester will be opened to save
  1430. the config. The configname can be changed if you want. Every setting that
  1431. has been changed will be saved in the config file. The configfile is in ASCII
  1432. format and can be found in the data/ directory. The default path of this
  1433. data directory will be saved in the env: envarc: directory under the name
  1434. REQUESTORPath.
  1435.  
  1436.  
  1437. Make Config
  1438. -----------
  1439.  
  1440. Keyboard short-cut: Right-Amiga M
  1441.  
  1442. To easily make a config file is this option implanted. This menu will open
  1443. the Spot prefs files and look for any information that could be useable for
  1444. REQUESTOR.
  1445.  
  1446. Next four settings would be taken from the Spot prefs file. For each bbs you
  1447. are recieving mail from, a separated config will be made with a name choosen
  1448. by you for that bbs.
  1449.  
  1450. - BBS Name
  1451. - Your Node
  1452. - Request File
  1453. - Import Dir
  1454.  
  1455. PS) Al the rest of settings stay like they are. The last save config will be
  1456. still in memory !
  1457.  
  1458.  
  1459. Restore Mail
  1460. ------------
  1461.  
  1462.    Restore last received mail. After an import by Spot all mail
  1463.    inbound/#?.pkt and #?.day files are deleted automatically. Normally you
  1464.    will not be able to get back deleted messages. REQUESTOR stores
  1465.    a backup of all received .pkt, .day-files when the mailbackup option is
  1466.    set.
  1467.    Selecting this menu item popups a reqtools requester asking how many days
  1468.    you want to restore from mail back to your mail:inbound/ directory. So you
  1469.    can import again in Spot or Decrunch in REQUESTOR.
  1470.    See also option 'delete backupmail'
  1471.  
  1472.  
  1473. Restore Request
  1474. ---------------
  1475.  
  1476.    Restore last saved request. A handy option to bring back what you did
  1477.    request last. Remember this will overwrite the recent request !
  1478.  
  1479.  
  1480. Buttons
  1481. -------
  1482.  
  1483.      Sequence
  1484.  
  1485.   '    Poll    '
  1486.   '  Decrunch  '
  1487.   '    Quit    '
  1488.  
  1489.       Status
  1490.  
  1491.   'Cycle gadget'
  1492.   '   Erase    '
  1493.  
  1494.       Session
  1495.  
  1496.   '  AppTimer  '
  1497.   '   Force    '
  1498.  
  1499.  
  1500. Poll
  1501. ----
  1502.  
  1503. Keyboard short-cut: P
  1504.  
  1505. See menu-item 'Poll'
  1506.  
  1507.  
  1508. Decrunch
  1509. --------
  1510.  
  1511. Keyboard short-cut: D
  1512.  
  1513. See menu-item 'Decrunch'
  1514.  
  1515.  
  1516. Quit
  1517. ----
  1518.  
  1519. I think you get the picture. ;-) This will quit the program and will first
  1520. ask if its necessary to save the changes that were made.
  1521.  
  1522.  
  1523. Cycle Gadget Session
  1524. --------------------
  1525.  
  1526. With this cycle gadget it will be possible to set which type of result you
  1527. want to see in the listview.
  1528.  
  1529. Possible positions of this cycle gadget wil be :
  1530.  
  1531.  'Actions'
  1532.  'All Req'
  1533.  'Request'
  1534.  'Inbound'
  1535.  
  1536.  
  1537. Actions Listview
  1538. ----------------
  1539.  
  1540. At this point you can see all what has happend in the listview. Selecting a
  1541. text in the listview will do nothing.
  1542.  
  1543.  
  1544. All Requested Files Listview
  1545. ----------------------------
  1546.  
  1547. At this point you can see all the files you did request earlier. You will be
  1548. only able to see as far the list view goes. To go further in the list push
  1549. the space bar to continu. This is done to save memory. This list could get
  1550. megas long. It would be stupid to load them all in memory.
  1551.  
  1552. Selecting a earlier requested file from the listview will popup a reqtools
  1553. requester that will be asking to add this request or not.
  1554.  
  1555.  
  1556. Request Listview
  1557. ----------------
  1558.  
  1559. At this point you can see what you are going to request on next poll.
  1560. Selecting a request from the listview will do nothing.
  1561.  
  1562.  
  1563. Inbound Listview
  1564. ----------------
  1565.  
  1566. At this point you can see what there will be in your inbound directory.
  1567. Selecting a file from the listview will popup a reqtools requester asking to
  1568. delete that file are not.
  1569.  
  1570.  
  1571. Erase Button
  1572. ------------
  1573.  
  1574. This button its job depends on the position of the cycle gadget.
  1575.  
  1576. Possible positions of this cycle gadget will be :
  1577.  
  1578.  'Actions'
  1579.  'All Req'
  1580.  'Request'
  1581.  'Inbound'
  1582.  
  1583.  
  1584. Erase Status Listview
  1585. ---------------------
  1586.  
  1587. When selecting this erase button the listview will be cleared.
  1588.  
  1589.  
  1590. Erase Allready Requested Files Listview
  1591. ---------------------------------------
  1592.  
  1593. When selecting this button you will be asked to delete the entirely allready
  1594. requested filelist.
  1595.  
  1596.  
  1597. Erase Filerequested Listview
  1598. ----------------------------
  1599.  
  1600. When selecting this button you will be asked to delete the entirely request.
  1601.  
  1602.  
  1603. Erase INBOUND Listview
  1604. ----------------------
  1605.  
  1606. When selecting this button you will be asked to delete the entirely INBOUND:
  1607. directory.
  1608.  
  1609.  
  1610. AppTimer
  1611. --------
  1612.  
  1613. When pushing this button REQUESTOR will close all its screens and add a
  1614. appicon to the workbench. When the appicon is active the clock can be used
  1615. when this option is set on. Double clicking this appicon will reopen all
  1616. screens and windows again ready to use. You can drop icons to on the
  1617. appicon. This will reopen the screens and windows and starts unpacking from
  1618. the dropped archives if possible.
  1619.  
  1620.  
  1621. Force decrunch
  1622. --------------
  1623.  
  1624. You have to set this option when you want to decrunch allready decrunched
  1625. archives in the inbound directory. Normaly after unpacking the archives
  1626. there will be set an archive bit to the file so it will know the file is
  1627. allready handled. When the force decrunch checkbox is set on the archive bit
  1628. will be skipped and everything will be decrunched every time untill the
  1629. checkbox is set off again.
  1630.  
  1631.  
  1632. Icon Tooltypes
  1633. --------------
  1634.  
  1635. Icon tooltypes settings.
  1636.  
  1637. Click on the iconfile and select information from the workbench menu.
  1638. Remove the brackets if you want to make a tooltype active.
  1639. I left you the possibility to change these settings because its
  1640. default setting are kept low for memory saving. But every user
  1641. could need more items then the default settings.
  1642.  
  1643. (CONFIG=Alpha.config)
  1644.  
  1645. Add the name of the configfile you want to use at startup after the
  1646. keyword CONFIG=. This will only work if you are running from workbench,
  1647. otherwise you have to use the cli arguments.
  1648.  
  1649. (ACTIONLIST=50) default 50
  1650.  
  1651. This will be the listview where you could see all actions that are been
  1652. made by Requestor (main window). This could be in a range of 50 -> 500.
  1653. If you request a lot, you will notice this has to be increased a little
  1654. to see everything that has happened and scroll through it.
  1655.  
  1656. (PHONELIST=5) default 5
  1657.  
  1658. This will be the listview where you could see all phonenumbers that are
  1659. added (Setting\BBS). This could be in a range of 5 -> 100.
  1660.  
  1661. (FREQUENTLYLIST=5) default 5
  1662.  
  1663. This will be the listview where you could see all frequently requested
  1664. files that are added (Setting\Frequently\Frequently). This could
  1665. be in a range of 5 -> 100.
  1666.  
  1667. (AFTERSESSIONLIST=5) default 5
  1668.  
  1669. This will be the listview where you could see all aftersession programs
  1670. that are added (Setting\Frequently\Aftersession). This could be in
  1671. a range of 5 -> 100.
  1672.  
  1673. (DIFFLIST=5) default 5
  1674.  
  1675. This will be the listview where you could see all diff files that are
  1676. added (Setting\Frequently\Diffs). This could be in a range of
  1677. 5 -> 100.
  1678.  
  1679. (EXTENTIONLIST=5) default 5
  1680.  
  1681. This will be the listview where you could see all extention files that
  1682. requestor has to move (Setting\Frequently\Extention move). This could
  1683. be in a range of 5 -> 100.
  1684.  
  1685. (DELIMPORTLIST=5) default 5
  1686.  
  1687. This will be the listview where you could see all the received files
  1688. that have to be deleted (Setting\Delete files). This could be in
  1689. a range of 5 -> 100.
  1690.  
  1691. (DELINARCHIVELIST=5) default 5
  1692.  
  1693. This will be the listview where you could see all the files that
  1694. has to be deleted in the received archives (Setting\Delete files).
  1695. This could be in a range of 5 -> 100.
  1696.  
  1697. (DONOTWAIT)
  1698.  
  1699. This tooltype have to be added if Requestor runs from WBStartup !
  1700.  
  1701.  
  1702. CLI Argument
  1703. ------------
  1704.  
  1705. Look at the 'Multiple Pointsystem' section to have a explanation of the
  1706. useable CLI arguments.
  1707.  
  1708.  
  1709. Config File
  1710. -----------
  1711.  
  1712. The config file is accessable in the data directory and can be changed with an
  1713. ASCII text editor like Golded. It is very important to do everything the
  1714. same way like you see at this explaination chapter ! When spaces are used
  1715. they have to be used in all cases or REQUESTOR can't find its settings. When
  1716. REQUESTOR did not found its settings the default settings will be used !
  1717.  
  1718. When you have not enough memory it will be always possible to do some tricks
  1719. to save memory. Let say you will have REQUESTOR decrunching all your received
  1720. diff files. But not the proccesing of the nodelist using TrapList, you have
  1721. planned to do this after REQUESTOR has finished. Change the path of TrapList
  1722. then to "" (<- Empty, Nothing or a directory that not exists). At this point
  1723. REQUESTOR will not be able to run TrapList (you will get a little error
  1724. message) and everything will be done except TrapList processing the diff files.
  1725.  
  1726. REQUESTOR PREFS 2.0       Config version
  1727. SCREEN                    -> All screen settings
  1728.   SCREENTYPE PUBLIC       -> Public screen
  1729.   PUBSCREENAME SPOT       -> PublicScreen Spot
  1730.   SCREENWIDTH 702         -> Width of screen
  1731.   SCREENHEIGHT 278        -> Height of screen
  1732.   SCREENDEPTH 2           -> Depth (Depth^2=colors) of screen
  1733.   SCREENMODE 167936       -> Do not change unless you know what it will be !
  1734.   FONT topaz.font         -> Fontname
  1735.   FONTHEIGHT 8            -> Fontheight
  1736.   FONTSTYLE 0             -> Font style (not used, future development)
  1737. SCREENPENS                ColorPens
  1738.   GADGETTEXT 1            -> Default 1, gadget color
  1739.   SHINE 2                 -> Default 2, gadget shine color
  1740.   SHADOW 1                -> Default 1, gadget shadow color
  1741.   WINDOWTITLEBACKGROUND 3 -> Default 3, color background window title
  1742.   WINDOWTITLETEXT 1       -> Default 1, color text of window title
  1743.   GADGETBACKGROUND 0      -> Default 0, color background gadget
  1744.   HIGHLIGHT 1             -> Default 1, color selected gadget
  1745.   SLIDERBACKGROUND        -> Default 0, color background slider gadgets
  1746.   SLIDER                  -> Default 1, color front slider gadgets
  1747.   MENUTEXT 1              -> Default 1, color text menu
  1748. PALETTE                   Palette = Colorregisters (in AGA format)
  1749.   COLOR 0,160,160,160     -> First bitplane colors (non aga = 1/16)
  1750.   COLOR 1,0,0,0           -> Next bitplane colors
  1751.   COLOR 2,240,240,240     -> Next bitplane colors
  1752.   COLOR 3,96,128,176      -> Next bitplane colors
  1753. WINDOW SIZE               Window Size
  1754.   XPOS 0                  -> x-position of window, on Public screen
  1755.   YPOS 4                  -> y-position of window, on Public screen
  1756.   WIDTH 702               -> width of window, on Public screen
  1757.   HEIGHT 224              -> height of window, on Public screen
  1758. OPTIONS                   Options
  1759.   AUTOPOLL OFF            -> Automatic polling on startup, off/on
  1760.   AUTOQUIT OFF            -> Automatic quiting on startup, off/on
  1761.   BACKUPMAIL ON           -> Make backup received mail, off/on
  1762.   CHECKREQUESTED ON       -> Check for dupes, off/on
  1763.   DELSOURCE OFF           -> Delete source after decrunching, off/on
  1764.   AUTOIMPORT ON           -> Do automatic a Spot import, off/on
  1765.   DECRFILEREQUEST ON      -> Automatic decrunch all requested files, off/on
  1766.   DECRDIFFS ON            -> Automatic decrunch received diffs, off/on
  1767.   DECRFILEATTACH ON       -> Automatic decrunching all requested files, off/on
  1768.   AUTOSESSION OFF         -> Do a compete session on startup, off/on
  1769.   DELINSIDEARCHIVE ON     -> Delete files in archive before decrunching
  1770.                              off/on
  1771.   FREQREQUEST ON          -> Frequently request off/on
  1772.   AFTERSESSION ON         -> Aftersession programs off/on
  1773.   EXTENTIONMOVE ON        -> Moving files by extentionmark off/on
  1774.   USETIMER OFF            -> Use REQUESTOR internal clock to poll off/on
  1775.   ICONADD ON              -> Add icon to all received archives off/on
  1776.   ICONIFY OFF             -> Iconify when starting up off/on
  1777.   DELBACKUPMAIL ON        -> Delete backupmail older then ...off/on
  1778.   FORCEIMPORT OFF         -> Force Spot to import (for not registered
  1779.                              TrapDoor users) off/on
  1780. PATHS                     Path Settings
  1781.   LHA Workbench:c2/       -> Lha Path (for unpacking)
  1782.   UNZIP Workbench:c2/     -> Unzip Path (for exploding, unpacking)
  1783.   SPOT Workbench:Spot/    -> Spot Path (for mail import)
  1784.   TRAPDOOR Workbench:c2/  -> TrapDoor Path (for bbs communication)
  1785.   TRAPLIST Workbench:c2/  -> TrapList Path (for nodelist handling)
  1786.   ZIP Workbench:c2/       -> Zip Path (for viewing archives)
  1787. BBS                                 BBS Settings
  1788.   BBSNAME Nightbreed                -> Name of bbs (not necessary)
  1789.   NODE 2:292/603.35                 -> Pointnumber (nodename)
  1790.   REQFILE Outbound:2.292.603.0.REQ  -> FilePath file to do request with
  1791.   IMPORTDIR Inbound:                -> Path where all files will be received
  1792.   DESTINATIONDIR Workbench:bbs/New/ -> Path where all requested, decrunched
  1793.                                        files come to
  1794.   FILEATTACHDIR Workbench:bbs/New/  -> Path where all other, decrunched
  1795.                                        files come to
  1796. PHONE LIST                          Phone list
  1797.    10 016640099                     -> Time in seconds to wait, first
  1798.                                        phonenumber
  1799.    10 016640872                     -> Time in seconds to wait, next
  1800.                                        phonenumber
  1801.    10 016640912                     -> Time in seconds to wait, next
  1802.                                        phonenumber
  1803. FREQUENTLY DESTINATIONS             Destination dir frequently settings
  1804.   TYPE 0 Dh0:Filelists/             -> 0=Frequently requested files,
  1805.                                          Destination directory.
  1806.   TYPE 1                            -> 1=Not used
  1807.   TYPE 2 Nodelist:                  -> 2=Nodelist, Destination directory.
  1808.   TYPE 3 RAM:                       -> 3=Extention move, Destination
  1809.                                          directory.
  1810. FREQUENTLY LIST                     List of frequently requested files
  1811.     7 29/01/1995 amigafiles.lha     -> 7=days to wait, next request date,
  1812.                                          file to request
  1813. AFTERSESSION LIST                   List of aftersession progs
  1814.   C:Dir Dh0:                        -> Start c:dir argument dh0:
  1815.   C:execute s:countsessions.batch   -> Execute scriptfile
  1816.   C:Run VirusChecker                -> Run in background
  1817. DIFFS LIST                          NodeList Lists
  1818.   Nodediff.z??                      -> Nodediff.z (.z=zip archive /
  1819.                                                    ??=unknown chars)
  1820.   Amydiff.l??                       -> Amydiff.l? (.l=lha archive /
  1821.                                                    ??=unknown chars)
  1822. MOVE LIST                           Extention Move List
  1823.   .arj       PC:MsDos/              -> Right side chars EQ chars,
  1824.                                        destination directory
  1825.   .tiff      Pictures/tiff          -> Right side chars EQ chars,
  1826.                                        destination directory
  1827.   .jpeg      Pictures/Jpeg          -> Right side chars EQ chars,
  1828.                                        destination directory
  1829. DELETE FILES LIST                   Deleting unwanted files list
  1830.   BBSInfo                           -> Delete BBSInfo file if received in
  1831.                                        Inbound:
  1832. DELETE INSIDE ARCHIVE               Deleting files inside archive
  1833.   +32-16-640099                     -> Deleting unwanted information file in
  1834.                                        archive
  1835.   FILE_ID.DIZ                       -> Deleting unwanted information file in
  1836.                                        archive
  1837.   +32-16-640872                     -> Deleting unwanted information file in 
  1838.                                        archive
  1839. TIMER                               Internal Clock
  1840.   STARTHOUR 23                      -> Hour to start REQUESTOR Poll session
  1841.   STARTMINS 7                       -> Minutes to start REQUESTOR Poll
  1842.                                        session
  1843. SYSTEM                              REQUESTOR System files
  1844.   DAYS 7                            -> position days slider gadget
  1845.   DELAY 10                          -> position delay slider gadget
  1846.   LASTPENS 0                        -> Position colorpens cyclegadget
  1847.   LASTFREQTYPE 1                    -> Position Frequently cyclegadget
  1848.   DELBACKUPMAIL 1                   -> Position slidergadget delete backupmail
  1849.                                        older then ...
  1850. CLI con:0/300//50/test/screen Spot  CLI output device
  1851. END OF CONFIG                       Mark, end of config
  1852.  
  1853.  
  1854. Requestor Junior
  1855. ----------------
  1856.  
  1857. Because Requestor will do so much for you it will take a lot of memory
  1858. (see 'Acknowledgements'). Therefore I created a reduced version
  1859. of Requestor. All possibilities to change your settings are removed from
  1860. Requestor.Junior. Everything else will be the same, this means
  1861. Requestor.Junior takes 80kb less then Requestor. If you want to change
  1862. some settings you have to run Requestor and for general usage you can
  1863. use Requestor.Junior
  1864.  
  1865.  
  1866. Legal Stuff
  1867. -----------
  1868.  
  1869.   'License          '
  1870.   'No Warranty      '
  1871.   'Disclaimer       '
  1872.   'How To Register ?'
  1873.   'Acknowledgements '
  1874.   'Trademarks       '
  1875.  
  1876.  
  1877. License
  1878. -------
  1879.  
  1880.    This license applies to the product called "REQUESTOR", a program for the
  1881. Amiga computer, published by Stephan Kortleven under the concepts of
  1882. ShareWare, and the accompanying documentation, example files and
  1883. anything else that comes with the original distribution.  The terms
  1884. "Program" and "REQUESTOR" below, refer to this product.  The licensee is
  1885. addressed as "you".
  1886.  
  1887.      * You may copy and distribute verbatim copies of the program's
  1888.      executable code and documentation as you receive it, in any
  1889.      medium, provided that you conspicuously and appropriately publish
  1890.      only the original, unmodified program, with all copyright notices
  1891.      and disclaimers of warranty intact and including all the
  1892.      accompanying documentation, example files and anything else that
  1893.      came with the original.
  1894.  
  1895.      * You may not copy and/or distribute this program without the
  1896.      accompanying documentation and other additional files that came
  1897.      with the original.  You may not copy and/or distribute modified
  1898.      versions of this program.
  1899.  
  1900.      * You may not copy, modify, sublicense, distribute or transfer the
  1901.      program except as expressly provided under this license.  Any
  1902.      attempt otherwise to copy, modify, sublicense, distribute or
  1903.      transfer the program is void, and will automatically terminate
  1904.      your rights to use the program under this license.  However,
  1905.      parties who have received copies, or rights to use copies, from
  1906.      you under this license will not have their licenses terminated so
  1907.      long as such parties remain in full compliance.
  1908.  
  1909.      * By copying, distributing and/or using the program you indicate
  1910.      your acceptance of this license to do so, and all its terms and
  1911.      conditions.
  1912.  
  1913.      * Each time you redistribute the program, the recipient
  1914.      automatically receives a license from the original licensor to
  1915.      copy, distribute and/or use the program subject to these terms and
  1916.      conditions.  You may not impose any further restrictions on the
  1917.      recipients' exercise of the rights granted herein.
  1918.  
  1919.      * You may not disassemble, decompile, re-source or otherwise
  1920.      reverse engineer the program.
  1921.  
  1922.      * You may use the programs for a period of up to 30 days for
  1923.      evaluation.  After that, you have to register.
  1924.  
  1925.      * If you wish to incorporate parts of the programs into other
  1926.      programs, write to the author to ask for permission.
  1927.  
  1928.      * You agree to cease distributing the program and data involved if
  1929.      requested to do so by the author.
  1930.  
  1931.      * You may charge a fee to recover distribution costs.  The fee for
  1932.      diskette distribution may not be more than the cost to obtain a
  1933.      public domain diskette from Fred Fish.
  1934.  
  1935.  
  1936. No Warranty
  1937. -----------
  1938.  
  1939.    THERE IS NO WARRANTY FOR THE PROGRAMS, to THE EXTENT PERMITTED BY
  1940. APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  1941. HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAMS "AS IS" WITHOUT
  1942. WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  1943. LIMITED to, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  1944. PARTICULAR PURPOSE.  THE ENTIRE RISK AS to THE QUALITY AND PERFORMANCE
  1945. OF THE PROGRAMS IS WITH YOU.  SHOULD THE PROGRAMS PROVE DEFECTIVE, YOU
  1946. ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  1947.  
  1948.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED to IN
  1949. WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  1950. REDISTRIBUTE THE PROGRAMS AS PERMITTED ABOVE, BE LIABLE to YOU FOR
  1951. DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
  1952. DAMAGES ARISING OUT OF THE USE OR INABILITY to USE THE PROGRAMS
  1953. (INCLUDING BUT NOT LIMITED to LOSS OF DATA OR DATA BEING RENDERED
  1954. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF
  1955. THE PROGRAMS to OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER
  1956. OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  1957.  
  1958.  
  1959. Disclaimer
  1960. ----------
  1961.  
  1962.    No warranty, either express or implied, is made with respect to the
  1963. fitness or merchantability of REQUESTOR.
  1964.  
  1965.    Stephan Kortleven (referred to as "the author"), reserves the right to
  1966. not develop any future versions of REQUESTOR.
  1967.  
  1968.    The author will try to make a good faith attempt at correcting any
  1969. problems if any are discovered, but is in no way required, nor bound to
  1970. correct them.
  1971.  
  1972.    The author neither assumes nor accepts any responsibility for the
  1973. use or misuse of these programs.  He will also not be held liable for
  1974. damages or any compensation beyond the original registration fee due to
  1975. loss of profit or any other damages arising out of the use, or
  1976. inability to use this program.
  1977.  
  1978.    The author will not be liable for any damage arising from the
  1979. failure of this program to perform as described, or any destruction of
  1980. other programs or data residing on a system attempting to run the
  1981. programs.  The user of this program uses it at his or her own risk.
  1982.  
  1983.  
  1984. How To Register
  1985. ---------------
  1986.  
  1987.   1. Print out the "REQUESTOR Software Registration Form".  The registration
  1988.      form can be found in the REQUESTOR distribution archive as
  1989.      `World').  You can use the `Print.World' icon to print it
  1990.      out easily.
  1991.  
  1992.   2. Please print or write LEGIBLY...
  1993.  
  1994.        a. Fill in your name and mailing address.
  1995.  
  1996.        b. Your fidonet address (not required, but if present you will be
  1997.           notified when your copy is shipping).
  1998.  
  1999.        c. Your private voice telephone number (not compulsory).  If
  2000.           possible, use the form "+32-(16)-123456", where 32 is the
  2001.           country code and 16 is the area code.
  2002.  
  2003.   3. Tick...
  2004.  
  2005.        a. Decide how to transfer the money.  Cash (at your own risk), a
  2006.           postal money order, a wire bank transfer or a EuroCheck (only
  2007.           in BEF!) are suggested.  Foreign checks are *NOT* accepted!
  2008.  
  2009.        b. Decide which way you would like to receive your keyfile.
  2010.  
  2011.   4. Send the registration form to me. ;-)
  2012.  
  2013.               Stephan Kortleven
  2014.               Nattehofstraat 104
  2015.               2800 Mechelen - Belgium
  2016.           
  2017.               Bank account: 789-5646277-22
  2018.               Bank: BAC, Oscar Van Kesbeekstraat 72 , 2800 Mechelen - Belgium
  2019.  
  2020.   5. Wait for your key to be delivered.  Thank you for registering!
  2021.      You should receive your key within 8 days after the arrival of
  2022.      your registration fee.  But please allow up to eight weeks for
  2023.      delivery, due to unforseen circumstances.
  2024.  
  2025.   6. A keyfile is proof of the personal license you have to use REQUESTOR.
  2026.      You are not allowed to sell or give away the keyfile.
  2027.  
  2028.  
  2029. Acknowledgements
  2030. ----------------
  2031.  
  2032.  * REQUESTOR needs the following library's
  2033.  
  2034.   Graphics.library
  2035.   Nudos.library
  2036.   Intuition.library
  2037.   Dos.library
  2038.   Exec.library
  2039.   Gadtools.library
  2040.   Mathffp.library
  2041.   Mathtrans.library
  2042.   Diskfont.library
  2043.   Reqtools.library
  2044.   Icon.library
  2045.   Rexxsyslib.library
  2046.   Intuition.library
  2047.   REXXSYSLIB.LIBRARY
  2048.   Workbench.library
  2049.   Asl.library
  2050.  
  2051. PS) don't worry if you don't have them, all of these librarys are internal
  2052. to your Rom chip or are included by your OS (Workbench). Otherwise they are
  2053. included to the REQUESTOR code. So you will not be needing any of them
  2054. externally or to add them.
  2055.  
  2056.  * REQUESTOR uses one external program, but this is included to
  2057. your rom chip so you don't have to stay awake "worrying" about it.
  2058.  
  2059.    Run
  2060.  
  2061. Next 6 programs are needed by REQUESTOR to do its work.
  2062.  
  2063.    TrapDoor  for modem communications
  2064.    TrapList  for handling nodelist, amylist etc..
  2065.    Lha       for unpacking archives
  2066.    Zip       for viewing archives
  2067.    Unzip     for unpacking archives
  2068.    Spot      for automatic mail handling
  2069.  
  2070. Important : REQUESTOR has been tested in combination with:
  2071.  
  2072.     TrapDoor V 1.85
  2073.     TrapList V 5.19
  2074.     Lha      V 1.38
  2075.     Zip      V 2.0.1
  2076.     Unzip    V 3.0
  2077.     Spot     V 1.3a
  2078.  
  2079. REQUESTOR completely installed takes +/- a 400.000 bytes of memory. Running the
  2080. guidefile from it will take +/- 93.000 bytes more. So, if you are running from
  2081. Spot remember you will need a minimum of 400.000 bytes free memory when Spot is
  2082. running !
  2083. Requestor.Junior completely installed takes 75.000 bytes less then Requestor.
  2084.  
  2085.  
  2086. trademarks
  2087. ----------
  2088.  
  2089.    The following names are either trademarks or the efforts of the
  2090. person and/or company listed:
  2091.  
  2092. * Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  2093. * ARexx by William S. Hawes, Wishful Thinking Development Corp.
  2094. * Fido and FidoNet are trademarks of Tom Jennings, Fido Software.
  2095. * TrapDoor is a registered trademark of Maximilian Hantsch and Martin
  2096.   Laubach.
  2097. * TrapList and TrapList.library by Maximilian Hantsch and Martin
  2098.   Laubach.
  2099. * Zip Copyright (C) 1990-1993 Mark Adler, Richard B. Wales, Jean-loup Gailly,
  2100.   John Bush and Paul Kienitz.
  2101. * UnZip:  Zipfile Extract v5.1d BETA of 22 Oct 92; (c) 1989 S.H.Smith and
  2102.   others
  2103. * Reqtools.library is (c) by Nico François 1991-1994
  2104. * Blitz BLITZ BASIC 2 - Release 1.0 - (C)opyright 1991 - Acid Software
  2105.   Designed and Programmed by Mark Sibly
  2106.  
  2107.  
  2108. Special thanks
  2109. --------------
  2110.  
  2111.    A special thank you to the following people for alpha and beta
  2112. testing (in random order):
  2113.  
  2114.  - Peter Stuer
  2115.  - Nico Francois
  2116.  - Litrik De Roy
  2117.  - Lieven Lema
  2118.  - Emiel Marien
  2119.  - Eddy Toelen
  2120.  - Eddie Vangoetsenhoven
  2121.  - Jean-Pierre Lagaisse
  2122.  
  2123. Beta testing is done on next machines :
  2124.  
  2125.  - A600  2 CHIP/0   Fast OS 2.1 Kickstart 37.300, Workbench 38.24
  2126.  - A1200 2 CHIP/0   Fast OS 3.0 Kickstart 39.106, Workbench 39.29
  2127.  - A1200 2 CHIP/4   Fast OS 3.0 Kickstart 39.106, Workbench 39.29
  2128.  - A2000 1 CHIP/8   Fast OS 3.1 Kickstart  40.63, Workbench 40.42
  2129.  - A3000 2 CHIP/2.5 Fast OS 3.1 Kickstart  40.68, Workbench 40.35
  2130.  - A4000
  2131.  
  2132. For making my written English readable for you :
  2133.  
  2134.  - Lieven Lema (if only I had more time :-))
  2135.  - Eddy Toelen
  2136.  
  2137. For making the beautiful REQUESTOR-Icons :
  2138.  
  2139.  - David De Groot
  2140.  
  2141. For License agreement and legal mumbo jumbo largely stolen from Spot
  2142. manual and for his development of the great reqtools library :
  2143.  
  2144.  - Nico Francois
  2145.  
  2146. For the beautiful language called Blitz :
  2147.  
  2148.  - Acid Software
  2149.  
  2150. And all the Blitz public library developers :
  2151.  
  2152.  - Aaron Koolen, Vision Software
  2153.  - Richard T Elmore, HeadSoft
  2154.  - Steve Mc
  2155.  - Peter Tavinor
  2156.  - Neil O'Rourke
  2157.  - Steven Matty, Leading Edge Software
  2158.  - Andre Bergmann
  2159.  
  2160. For the endless support, my sysop :
  2161.  
  2162.  - Herman Stevens, Nightbreed BBS.
  2163.  
  2164. My wife for the great support. ;-)
  2165.  
  2166. Commodore for the beautiful computers I have !
  2167.  
  2168. And all helpful people on the Blitz-list !
  2169.  
  2170.  
  2171.  
  2172. Program History
  2173. ---------------
  2174.  
  2175. Version 1.0
  2176.  
  2177.      First release.
  2178.  
  2179. Version 1.01
  2180.  
  2181. - Display message on cli argument '?' added -> NODE=PointNumber
  2182. - Not registered users - About message 'compiled to:' removed
  2183. - Early requested files check : 'ALL OK' or 'REMOVE ALL'
  2184.   Delay on 'found already requested files...' removed
  2185. - Early requested files check : 'REMOVE ALL' Bug fixed
  2186. - Crash 68000/68010 bug fixed
  2187.  
  2188. Version 1.02
  2189.  
  2190. - Crash on older Amiga's with only chipmem, bug removed.
  2191.  
  2192. Version 2.0
  2193.  
  2194. - Complete new restart of the program to get a user friendly gadtools
  2195.   interface.
  2196. - Supporting all screen formats
  2197. - lha, zip archiving/decrunching.
  2198. - Setting options
  2199. - deleting files,
  2200. - Locale support
  2201. - Enfrocer Hits removed !
  2202. - etc... too many to tell !
  2203.  
  2204.  
  2205. Future plans
  2206. ------------
  2207.  
  2208. - Other archivers...
  2209. - REQUESTOR screen changing to a Public Screen
  2210. - REQUESTOR starts up on a workbench a like screen
  2211. - REQUESTOR making SysIHack-friendly
  2212. - Catching TrapDoor failers which restart TrapDoor again for retries
  2213.   if wanted.
  2214. - Datatype or "WhatIs.library" support
  2215.  
  2216.  
  2217. Author Info
  2218. -----------
  2219.  
  2220.          Stephan Kortleven
  2221.          Nattehofstraat 104
  2222.          2800 Mechelen
  2223.          Belgium
  2224.      
  2225.          Internet: <stef@alpha.ixo.com>
  2226.          FidoNet : 2:292/603.35
  2227.  
  2228. PS) Please write me in case the following happens:
  2229.  
  2230. - You have any suggestion on commands or ideas that would improve REQUESTOR.
  2231. - You have a description of any bugs you may encounter.
  2232. - You want to be a registered user.
  2233. - You have make/found new Requestor catalogs or translated docs.
  2234.      
  2235. We always look at the bright side of life....
  2236.  
  2237.  
  2238. How did I do that ?
  2239. -------------------
  2240.  
  2241. Dear REQUESTOR user,
  2242.  
  2243.                     If you are wondering which programming language I
  2244.   used to make REQUESTOR you would be yelling. Oh no, not BASIC !
  2245.   Yes, BlitzBasic2. You will see its fully amigados compatible. Blitz2 has
  2246.   even the possibility to program directly in assembler. All used commands
  2247.   are 100% pure Assembler when compiled. Blitz2 is the language of the
  2248.   future for Amiga in its kind. The whole operating system lies open for you
  2249.   to use. You don't need to open a library. Its recently the most
  2250.   beautiful language I ever saw of this format. The support is even
  2251.   beautiful. There are BBS's that support Aminet-areas for Blitz-users
  2252.   'Blitz_amy'. Furthermore there is the possibility to go take a look at 
  2253.   usenet called the Blitzlist. A close Blitz-user-group working on all kinds
  2254.   of programs and helping each other out of problems. Try it out some time.
  2255.   There should be a PD-version on every bbs. If you register, you
  2256.   won't believe what you get for little money. +/- monthly a new update
  2257.   with about 100 new commands.
  2258.  
  2259.   I know the editor doesn't seem beautiful at first time but its
  2260.   the result you get from working with it that counts. And take it from
  2261.   me you will quickly get the virus, and will want some more.
  2262.  
  2263.   Thanks Acid Software !
  2264.  
  2265.  
  2266. Possible failures
  2267. -----------------
  2268.  
  2269. 1° REQUESTOR tells on the status line to wait for importing mail
  2270.    and stays waiting.
  2271.  
  2272.    solution
  2273.  
  2274.    reset your amiga and set Spot settings/system/Asynchronous switch on and
  2275.    leave Spot so you can click the save button.
  2276.  
  2277. 2° TrapList diffprocessing takes al lot of memory. It wil be possible that
  2278. you are running out of memory.
  2279.  
  2280.    solution
  2281.  
  2282.    Change the TrapList path to a directory TrapList can't be found ! So,
  2283. REQUESTOR will not be able to run it. After REQUESTOR has finnisched you
  2284. could always run TrapList with more avaible memory.
  2285.  
  2286. 3° Requested files will be marked in the action listview as fileattach.
  2287.  
  2288.    You have requested a magic-filename, some BBS use a system that can
  2289. request files by a magic filename. Example : request Amiga, receive
  2290. Amigafiles.lha. Requestor is developed to decrunch the same as requested
  2291. so use the real name next time, Amigafiles.lha and not Amiga.
  2292.  
  2293. Known bugs !
  2294. ------------
  2295.  
  2296. I'm sorry to say there still are a couple of minor bugs in it. None of these
  2297. bugs will harm your system so don't be afraid for it. ;-)
  2298.  
  2299. 1° The reqtools save REQUESTORs could fail when you use 2 times a . in the
  2300. filename
  2301.  
  2302. 2° REQUESTOR is not SysIHack-friendly, if you don't known what this means
  2303. don't worry about it, you will not need it then. ;-)
  2304.  
  2305. 3° On OS 2.0 the gadtools colorboxes will not being disabled on a public
  2306. screen. I have still to fix that !
  2307.  
  2308. That's all folks, I know what to do...
  2309.  
  2310.  
  2311. INDEX
  2312. -----
  2313.  
  2314. 'Titlepage'
  2315.  
  2316.   'Preface'
  2317.  
  2318.   'Introduction'
  2319.  
  2320.   'Features'
  2321.  
  2322.   'What can it do ?'
  2323.  
  2324.   'Installation'
  2325.     'Multiple pointssystem'
  2326.  
  2327.   'Menus'
  2328.  
  2329.     Project
  2330.  
  2331.       'Poll'
  2332.       'Decrunch'
  2333.       'About'
  2334.       'Guide'
  2335.       'User'
  2336.       'Quit'
  2337.  
  2338.     Settings
  2339.  
  2340.       'General Settings'
  2341.         'Output device'
  2342.         'Public screen string'
  2343.         'Public/Custom screen'
  2344.         'Screen Selector'
  2345.         'Font Selector'
  2346.         'Palette Selector'
  2347.         'Color Selector'
  2348.         'Test Button'
  2349.         'Reset Button'
  2350.  
  2351.       'Path settings'
  2352.         'Path string'
  2353.         'Path requester'
  2354.  
  2355.       'BBS Settings'
  2356.         'BBS name'
  2357.         'Node name'
  2358.         'Request file, String'
  2359.         'Request file, Requester'
  2360.         'Import path, String'
  2361.         'Import path, Requester'
  2362.         'Destination path, String'
  2363.         'Destination path, Requester'
  2364.         'File attach path, String'
  2365.         'File attach path, Requester'
  2366.         'Phonenumbers'
  2367.         'Wait time'
  2368.  
  2369.       'Frequently Settings'
  2370.         'Frequently type'
  2371.           'Frequently'
  2372.           'Aftersession'
  2373.           'Diffs'
  2374.           'Extension'
  2375.         'Frequently destination, String'
  2376.         'Frequently destination, Requester'
  2377.         'Frequently action string'
  2378.         'Frequently file requester'
  2379.  
  2380.       'Auto Delete Settings'
  2381.         'Delete imported files'
  2382.         'Delete files in archives'
  2383.         'Delete backupmail'
  2384.  
  2385.       'Options settings'
  2386.         'Check Requested'
  2387.         'Frequently Request'
  2388.         'Delete Backupmail'
  2389.         'Poll'
  2390.         'Auto Session'
  2391.         'Backup Mail'
  2392.         'Import'
  2393.         'Force Import'
  2394.         'Delete In Archive'
  2395.         'Decrunch Filerequest'
  2396.         'Decrunch Diffs'
  2397.         'Decrunch Fileattach'
  2398.         'Delete Source Archive'
  2399.         'extension Move'
  2400.         'Aftersession'
  2401.         'Quit'
  2402.         'Use timer'
  2403.         'Add Icon On archive'
  2404.         'Iconify'
  2405.  
  2406.       'Timer Settings'
  2407.  
  2408.       'Config Settings'
  2409.         'Load Config'
  2410.         'Save Config'
  2411.         'Load Config As'
  2412.         'Make Config'
  2413.  
  2414.     Backup
  2415.  
  2416.       'Restore Backupmail'
  2417.       'Restore Request'
  2418.  
  2419.   'Buttons Main Window'
  2420.     'Poll'
  2421.     'Decrunch'
  2422.     'Quit'
  2423.  
  2424.     'Status'
  2425.       'Actions'
  2426.       'Earlier Requested Files'
  2427.       'File Request'
  2428.       'Inbound:'
  2429.  
  2430.     'Erase'
  2431.       'Erase Actions'
  2432.       'Erase Earlier Requested Files'
  2433.       'Erase File Request'
  2434.       'Erase Inbound:'
  2435.  
  2436.     'AppTimer'
  2437.     'ForceDecrunch'
  2438.  
  2439.   'Icon Tooltypes'
  2440.  
  2441.   'CLI arguments'
  2442.  
  2443.   'Config File'
  2444.  
  2445.   'Requestor Junior'
  2446.  
  2447.   'Legal Stuff'
  2448.     'License'
  2449.     'No warranty'
  2450.     'Disclaimer'
  2451.     'How to register'
  2452.     'Acknowledgements'
  2453.     'Trademarks'
  2454.  
  2455.   'Program History'
  2456.  
  2457.   'Future Plans'
  2458.  
  2459.   'Author Info'
  2460.  
  2461.   'Special Thanks'
  2462.  
  2463.   'How did I do ?'
  2464.  
  2465.   'Possible Failures'
  2466.  
  2467.